home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / asc2com.zip / README.DOC < prev    next >
Text File  |  1989-02-09  |  10KB  |  209 lines
  1.          Asc2Com.exe
  2.          Version 1.10
  3.          Copyright 1989
  4.          By  MorganSoft
  5.          All rights reserved.
  6.  
  7.  
  8.          ┌──────────────────────────────────────────────────────────┐
  9.          │This program is shareware:   For  registration information│
  10.          │run regisfrm.com. Registration fee is $10.00 and  entitles│
  11.          │you to use the program in any  fashion you deem,  is owned│
  12.          │by you personally, not limited to any particular computer.│
  13.          │MorganSoft assumes no liability  for any damages, material│
  14.          │or financial that may occur through  use of Asc2Com or any│
  15.          │programs generated by Asc2Com.                            │
  16.          └──────────────────────────────────────────────────────────┘
  17.  
  18.          SHAREWARE:    Please  feel  free to  distribute  the  program 
  19.          archive  to any all.   I  only ask that you keep the  archive 
  20.          intact.   If you're not familiar with the shareware  concept, 
  21.          it's  quite simple:   you try this program out and see if  it 
  22.          fits  your needs.   If it doesn't,  you don't use it.   If it 
  23.          does,  you fill out the registration form and send it back to 
  24.          me  with the fee.   YOU ONLY PAY FOR SOMETHING YOU  NEED  AND 
  25.          USE.   In any event,  I  do thank you for giving Asc2Com  and 
  26.          MorganSoft a try. 
  27.  
  28.          Programs in the archive are:
  29.  
  30.                 Asc2Com.Exe                 Executable prgm.
  31.                 Readme.Doc                  This file.
  32.                 Readme.Com                  This file's com clone.
  33.                 Color.Doc & Color.Com:      File detailing color
  34.                                                 byte format.
  35.                 Tab.Doc & Tab.Com           Example of tab 
  36.                                                 expansion.
  37.                 Regisfrm.Com                Program to print the
  38.                                                 registration form.
  39.          
  40.  
  41.  
  42.          Description:
  43.  
  44.          Asc2Com takes standard ASCII format file,  such as this  one, 
  45.          and  turns  them into executable file that are  self-listing.  
  46.          Output  display  is  command line  switchable  from  default, 
  47.          direct screen writing (Video adapter types:  CGA,  EGA,  VGA, 
  48.          MDA.)   to standard output  (redirectable),  enable Wait  for 
  49.          Retrace,   or  Pause  Mode.   Colors may be picked  from  any 
  50.          combination possible for CGA system and the programs produced 
  51.          sense  if  a  color  type display is available  on  the  host 
  52.          system.  If not, plain vanilla white on black will be used. 
  53.  
  54.          
  55.          Asc2Com Syntax:  At the DOS prompt, type the following:
  56.  
  57.                   C>Asc2Com myfile.txt /e #
  58.                       or
  59.                   C>Asc2Com myfile.txt # /e
  60.                       or
  61.                   C>Asc2Com myfile
  62.  
  63.          This  produces  a file called myfile.com  will  contains  the 
  64.          contents of myfile.txt, and will list it to the screen. 
  65.  
  66.          The options above may be in any order or omitted,  and do the 
  67.          following: 
  68.               
  69.               /e:  Expand tabs.  The default will treat any tabs found 
  70.                    in  the source file as characters,  displaying them 
  71.                    in  direct  write modes.   This option will  expand 
  72.                    them. 
  73.          
  74.               #:   Color Byte.   This  option  determines  the  output 
  75.                    colors for the file (default is 1E hex, 31 Decimal, 
  76.                    or a white on blue).  (See Color.Doc for a complete 
  77.                    breakdown  on  all  possible  color  combinations). 
  78.                    Please  note that 16  colors are available for  the 
  79.                    background color,  non-blinking.   If the file will 
  80.                    most  likely be used with the /s or /p options (see 
  81.                    below),   Blinking  will become active rather  than 
  82.                    intensity AFTER THE FIRST SCROLL.   Therefore,  you 
  83.                    mostly likely won't want any of the high  intensity 
  84.                    colors  for the background if redirected output  is 
  85.                    desired. 
  86.  
  87.  
  88.          Output File Syntax:  At the DOS prompt type the following:
  89.    
  90.                   C>myfile  
  91.                      or
  92.                   C>myfile /s
  93.                      or
  94.                   C>myfile /c
  95.                      or
  96.                   C>myfile /p
  97.  
  98.          The three options available for programs generated by Asc2Com 
  99.          do the following: 
  100.  
  101.               /s:  Disables  direct  screen  writes,  and  routes  all 
  102.                    displays  through  DOS.   Use this method  to  have 
  103.                    output directed to a serial device or printer. 
  104.  
  105.               /c:  Wait  for Retrace.   This option is only needed for 
  106.                    older  CGA  systems that produce snow  when  direct 
  107.                    video  writes  are used.   If a  generated  program 
  108.                    produces  snow,  use this.   Note,   however   that 
  109.                    displays are slowed down using this. 
  110.  
  111.               /p:  This   option is used when you want the program  to 
  112.                    simply list,  one direction only, to the screen. By 
  113.                    default,   this uses DOS to write to the screen (in 
  114.                    exactly  the same manner that the /s option  does).  
  115.                    No  back paging or scrolling is possible with  this 
  116.                    option. 
  117.          
  118.          With  the /c option or no options,  the the 25th line of  the 
  119.          screen will list available active keys, which are: 
  120.              
  121.          PgDn             UpKey           Home
  122.          PgUp             DnKey           End
  123.  
  124.          Which all work very much as you would expect.   (No cursor is 
  125.          visible in the program,  and Home takes you to the Top of the 
  126.          file, End, to the Bottom of the file). 
  127.  
  128.  
  129.          Use:   I developed this program for my own use,  specifically 
  130.          for  document  files  I include with the  programs  I  write.  
  131.          Oftimes,   my programs are used by people with  very  limited 
  132.          computer  experience and the idea of making the documentation 
  133.          as easy to read as possible was definitely a good one.  Since 
  134.          many   relatively  inexperienced  users  often  have  trouble 
  135.          loading files into the normal listing programs available,  or 
  136.          into word processors, I came up with this.  
  137.  
  138.  
  139.          Limitations:
  140.  
  141.          Asc2Com  will  truncate any characters past column 80   in  a 
  142.          file, so if you have anything past that point, I suggest that 
  143.          you edit the file before using Asc2Com.   To be honest,   I'm 
  144.          not  exactly  sure  how big a  file  can  be   processed. The 
  145.          limitations on com files (65278 bytes) applies of course, the 
  146.          actual size of the ASCII file can be a tad larger and   still 
  147.          be   packed  into  Com size.   All  Carriage Return/Line Feed
  148.          combinations are stripped from the program,  so if your  file 
  149.          has a lot of individual lines,  you'll gain one byte per line 
  150.          (I have to use one byte for actual string length).  You  lose 
  151.          the  length  of the assembler program off the top (about 1500 
  152.          bytes)   so I expect the practical maximum length is   around 
  153.          63500 bytes. 
  154.  
  155.          Most ASCII characters will be okay (excepting of course ASCII 
  156.          13--carriage return,  10--linefeed, 28--file separator,  29--
  157.          group separator).  
  158.  
  159.          Asc2Com was written in Turbo Pascal 5.0  and employs  nothing 
  160.          extraordinary.    The program simply takes a  typed  constant 
  161.          which  is,   in actual fact,  an com format file for  listing 
  162.          assembler  data  records,   and writes it out as  a  comfile.  
  163.          Next,   the source file is read in,  the lines counted,   and 
  164.          written  out byte by byte to that same comfile.   Finally,  a 
  165.          Seek  statement locates the proper file location  and  writes 
  166.          out  the overall Line count to the file,  then the color byte   
  167.          and closes it. 
  168.       
  169.          Lister.com   (the  actual listing program  incorporated  into 
  170.          each output file)   was written in 8088  assembler,  compiled  
  171.          and linked by Turbo Assembler 1.0.   Again,  nothing out   of 
  172.          the ordinary.    The command line switches  are very  simple:  
  173.          if the parameters are not exact matches, they DO NOT work.  I 
  174.          only check to see:  1/.  That the command tail is longer than 
  175.          0.    If it is, I  skip an assumed space byte and check for a 
  176.          "/".  If present, I then check  for either  a  "s", a "p", or 
  177.          a  "c".    The program dumps you  out  if  anything  else  is 
  178.          there. 
  179.  
  180.                   
  181.  
  182.  
  183.  
  184.          T. G. Browning
  185.          MorganSoft
  186.          2170 Raynor Street SE
  187.          Salem, OR   97302
  188.          (503)-399-8389
  189.  
  190.  
  191.  
  192.  
  193.  
  194.          Addendum 1: (No Doubt there'll be many more).
  195.  
  196.          Thanks  go  to two people who've helped by beta testing  this 
  197.          program  for  me:    Mike Heggen of Uff Dah Systems  and  Bud 
  198.          Rasmussen.    Mike informs me that his monitor (a Herc clone) 
  199.          DOES  NOT  WORK  on the default  option.    Weirdness  reigns 
  200.          because he also informs me that using the "/c"  option  gives 
  201.          him a display.   I'm at a complete loss to explain that.  So, 
  202.          if you've got a Herc or Herc clone, be warned that you may be 
  203.          stuck with using either one of the command line switches. 
  204.            
  205.          
  206.  
  207. END OF FILE.>>>
  208.  
  209.